docs: Move gdkcairo section to an external file

diff --git a/docs/reference/gdk/cairo.md b/docs/reference/gdk/cairo.md
new file mode 100644 (file)
index 0000000..f7d3c96
--- /dev/null
+++ b/docs/reference/gdk/cairo.md
@@ -0,0 +1,18 @@
+----
+Title: Cairo interaction
+----
+
+## Functions to support using cairo
+
+[Cairo](http://cairographics.org) is a graphics library that supports vector
+graphics and image compositing that can be used with GTK.
+
+GDK does not wrap the Cairo API; instead it allows to create Cairo
+drawing contexts which can be used to draw on [class@Gdk.Surface]s.
+
+Additional functions allow use [struct@Gdk.Rectangle]s with Cairo
+and to use [struct@Gdk.RGBA], `GdkPixbuf`, and [class@Gdk.Surface]
+instances as sources for drawing operations.
+
+For more information on Cairo, please see the
+[Cairo API reference](https://www.cairographics.org/manual/).

diff --git a/docs/reference/gdk/gdk4.toml.in b/docs/reference/gdk/gdk4.toml.in
index d64dc616ecf453066613efe7f7e2d987af1684e0..aa343b0a22b97c045245e80f571f5e2c4779b3ed 100644 (file)
--- a/docs/reference/gdk/gdk4.toml.in
+++ b/docs/reference/gdk/gdk4.toml.in
@@ -31,6 +31,9 @@ name = "basic"
 base_url = "https://gitlab.gnome.org/GNOME/gtk/-/blob/master/"
 
 [extra]
+content_files = [
+  "cairo.md",
+]
 content_images = [
   "images/gtk-logo.svg",
   "images/rotated-text.png",

diff --git a/gdk/gdkcairo.c b/gdk/gdkcairo.c
index d28b7e5b97618945726c301e2a0ac5dbb50181de..e36d08fefb1521e85494e1a646969a539b8386c9 100644 (file)
--- a/gdk/gdkcairo.c
+++ b/gdk/gdkcairo.c
@@ -23,22 +23,6 @@
 
 #include <math.h>
 
-/**
- * SECTION:cairo_interaction
- * @Short_description: Functions to support using cairo
- * @Title: Cairo Interaction
- *
- * [Cairo](http://cairographics.org) is a graphics
- * library that supports vector graphics and image compositing that
- * can be used with GDK and GTK.
- *
- * GDK does not wrap the cairo API, instead it allows to create cairo
- * contexts which can be used to draw on #GdkSurfaces. Additional
- * functions allow use #GdkRectangles with cairo and to use #GdkRGBAs,
- * #GdkPixbufs and #GdkSurfaces as sources for drawing operations.
- */
-
-
 /**
  * gdk_cairo_set_source_rgba:
  * @cr: a cairo context